home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / ixemul-complete / man / cat2 / chroot.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  59 lines
  1.  
  2. CHROOT(2)                  UNIX Programmer's Manual                  CHROOT(2)
  3.  
  4. NNAAMMEE
  5.      cchhrroooott - change root directory
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      cchhrroooott(_c_o_n_s_t _c_h_a_r _*_d_i_r_n_a_m_e)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      _D_i_r_n_a_m_e is the address of the pathname of a directory, terminated by an
  15.      ASCII NUL.  CChhrroooott() causes _d_i_r_n_a_m_e to become the root directory, that
  16.      is, the starting point for path searches of pathnames beginning with `/'.
  17.  
  18.      In order for a directory to become the root directory a process must have
  19.      execute (search) access for that directory.
  20.  
  21.      It should be noted that cchhrroooott() has no effect on the process's current
  22.      directory.
  23.  
  24.      This call is restricted to the super-user.
  25.  
  26. RREETTUURRNN VVAALLUUEESS
  27.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  28.      of -1 is returned and _e_r_r_n_o is set to indicate an error.
  29.  
  30. EERRRROORRSS
  31.      CChhrroooott() will fail and the root directory will be unchanged if:
  32.  
  33.      [ENOTDIR]     A component of the path name is not a directory.
  34.  
  35.      [ENAMETOOLONG]
  36.                    A component of a pathname exceeded {NAME_MAX} characters,
  37.                    or an entire path name exceeded {PATH_MAX} characters.
  38.  
  39.      [ENOENT]      The named directory does not exist.
  40.  
  41.      [EACCES]      Search permission is denied for any component of the path
  42.                    name.
  43.  
  44.      [ELOOP]       Too many symbolic links were encountered in translating the
  45.                    pathname.
  46.  
  47.      [EFAULT]      _P_a_t_h points outside the process's allocated address space.
  48.  
  49.      [EIO]         An I/O error occurred while reading from or writing to the
  50.                    file system.
  51.  
  52. SSEEEE AALLSSOO
  53.      chdir(2)
  54.  
  55. HHIISSTTOORRYY
  56.      The cchhrroooott() function call appeared in 4.2BSD.
  57.  
  58. 4.2 Berkeley Distribution        June 4, 1993                                1
  59.